home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / teach241.zip / {QIKREF.DOC < prev    next >
Text File  |  1992-12-07  |  6KB  |  123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.      ===============
  7.      QUICK REFERENCE
  8.      ===============
  9.  
  10.           CAITeach recognizes three questions, and one study template.
  11.      The template for each type is in a separate text file:
  12.               Study (information screen) ....... {T-STUDY.CHP
  13.               True-False Question............... {T-TF.CHP
  14.               Fill-In (Completion) Question..... {T-KB.CHP
  15.               Multiple Choice Question.......... {T-MC4.CHP
  16.  
  17.           Subtypes (e.g., modified matching, answer bank) may be created.
  18.           CAITests are prepared by merging templates into an master,
  19.      composing the question, checking line sequence, testing at DOS.
  20.               Syntax for DOS Test......... {TEACHTW FILE.EXT Title
  21.               Syntax for TW Test.......... #UTEACHTW.EXE FILE.EXE Title
  22.  
  23.      Characteristics of ALL Templates
  24.      ================================
  25.           All templates have 16 lines.  The first line requires a number
  26.      that denotes the line number of that question, and, optionally the
  27.      question number and starting line number of the next question.
  28.      That number is used by utilities such as {RENUM.  See Note 6.  That
  29.      number is typed into the file, or written with the utility, {RENUM.
  30.  
  31.      Arbitrary Divisions
  32.      ===================
  33.  
  34.           Templates, and their related questions are classed:
  35.  
  36.             1. The header .................................. first 5 lines
  37.             2. The text and mouse lines, if any ............. next 9 lines
  38.             3. The answer and answer note, if any ...,,,..... next 2 lines
  39.  
  40.           Each is detailed next, and illustrated in the generic template.
  41.  
  42.           HEADER: The header is always composed of five lines: the number,
  43.      comment, code, citation line, and the ruler line.
  44.           TEXT OR QUESTION:  The text or question part, including mouse lines
  45.      is always composed of nine lines.  Mouse lines, if any, vary with
  46.      template.  The program draws the mouse buttons.  The question is
  47.      written on the text lines.
  48.           ANSWER: The answer part is composed of two lines:  the answer
  49.      line which always displays, and an answer note line, which may or
  50.      may not display.  In the Study template the two answer lines are a
  51.      semicolon as there is no answer.
  52.  
  53.      Other Documentation
  54.      ===================
  55.           In addition to Quick Reference suggest you also use the
  56.      Numbering Aid (NumAid) as an immediate reference.  It is printed
  57.      from DOS with the command: TYPE {NUMAID.DOC > PRN.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      Generic Template Summary
  72.      ========================
  73.           See next two column display.  Numbers in the next two columns
  74.      on the left reference each line; those lines with an asterisk
  75.      display, even if blank.  Mouse buttons, and choices (A, B, C, or D)
  76.      for multiple choice, and [TRUE]/[FALSE] are drawn by CAITeach.
  77.  
  78.           - Line -                 - Remark on Line -
  79.       1 00001 = Q1 = 17   Required line number. See Note 6
  80.       2 ;                 Required (;), other for notes
  81.       3 [QCode]           Must have either STUDY, TF, KB, MC4
  82.       4*Citation Line     Citation, Teaching Point, etc.
  83.       5 Rule:r...:..      Format guide, 75 wide, See Note 7.
  84.       6*                  Question/Text .-----------------------------.
  85.       7*                  Question/Text :See below for template types :
  86.       8*                  Question/Text :Line 1 each template must    :
  87.       9*                  Question/Text :  have a number other than 0 :
  88.      10*                  Question/Text :     {RENUM will renumber    :
  89.      11*                  Question/Text :Line 3 must have either:     :
  90.      12*                  Question/Text :  STUDY, TF, MC4, or KB      :
  91.      13*                  Question/Text :-----------------------------:
  92.      14*                  Question/Text
  93.      15 Answer Line       Displays after student answer. See Notes: 1,2
  94.      16 Answer Note       See Note 5.
  95.           1. STUDY Type: Lines 15 and 16 start with semicolon.
  96.           2. FILL-IN: Answer is entered on line 15, any case, up to
  97.      50 characters.  Can not include tilde or percent sign.
  98.           3. TRUE-FALSE:  Enter question in text lines before line 13.
  99.      Mouse buttons are drawn on 13 by program.  Line 14 remains blank.
  100.           4. MULTIPLE CHOICE: Enter question in text lines before line 11.
  101.      Mouse "buttons" drawn by program on lines 11 and 13.  Choices A and
  102.      C, left column; B and D, right column.  Lines 12 and 14 remain blank.
  103.           5. To suppress display enter word "None," no quotes, no comma.
  104.           6. The first five spaces on the first line of each template must
  105.      contain a number other than 0.  For convenience, also include the
  106.      question number, and the beginning line number of the next question,
  107.      but program utilities use only the first five spaces.  Type the
  108.      number, or use the renumbering utility.  {NUMAID.DOC as an aid.
  109.           7. Margin and formatting guide, 75 characters wide.  Program
  110.      reads only first five spaces and expects to find "Rule:" ---
  111.      remainder of line may be erased, used for comment.
  112.  
  113.      Steps
  114.      =====
  115.         1. Prepare tutorial in TutorialWriter
  116.         2. Merge templates/questons into editor.  These are referenced
  117.            in the first paragraph, Page 1.  All start with "{T-."
  118.         3. Compose question
  119.         4. (Optional) Recommended: Manually renumber file, or check and
  120.               renumber with {RENUM. {RENUM must find a number on line 1
  121.         5. Check file at DOS. Command is:  {TEACHTW.EXE FILE.EXT Title
  122.         6. Call file from TutorialWriter: #U{TEACHTW.EXE FILE.EXT Title
  123.